home *** CD-ROM | disk | FTP | other *** search
/ Nothing but Tetris / Nothing but Tetris.iso / amiga / ahextris / ahextris.doc < prev    next >
Text File  |  1992-04-13  |  8KB  |  222 lines
  1.  
  2.  
  3.                                 AHextris 1.0
  4.  
  5.                                  6-Apr-1992
  6.  
  7.                              ⌐1992 by Ives Aerts
  8.  
  9.  
  10.  
  11.  
  12. 0.Preface
  13. =========
  14.  
  15.    AHextris is an extremely addictive, yet simple game.  The original idea
  16. came from David Markley who wrote the Unix version (xhextris) and put the
  17. source code in public domain.  Jeff Teague made a direct port of it to the
  18. Amiga and called it hextris. That version also is in public domain. What I
  19. did was rewrite it completely from scratch to make best use of the Amiga's
  20. capabilities.
  21.  
  22.    This game is Copyright (c) by Ives Aerts and may only be distributed
  23. in its complete, unmodified form (program and docs) and as long as only
  24. a moderate charge is asked for it.
  25.  
  26.    This game is shareware.  If you like this game I would appreciate it if
  27. you send me a contribution of $15 or 500Bfr (Belgian Francs). Please send
  28. money by international money order, EuroCheck (in Belgian Francs) or cash,
  29. 'cos it's quite expensive for me to cash in other checks. Registered users
  30. who supply an e-mail address or add 3$ (for a disk and postage) to the
  31. shareware fee, will receive full C-source code of the game. My address is:
  32.  
  33.                                   Ives Aerts
  34.                                Bareelstraat 36
  35.                                 2300 Turnhout
  36.                                    Belgium
  37.  
  38. 1.System requirements
  39. =====================
  40.  
  41.    To run AHextris you'll need OS2.04 or higher and reqtools.library
  42. V37 (included in the package) or higher. If you haven't got OS2.04 (or
  43. want to go for less features but no shareware contribution) then take
  44. a look at Jeff Teague's version.
  45.  
  46. 2.Playing the game
  47. ==================
  48.  
  49.    First of all you should copy reqtools.library to your LIBS: directory,
  50. either from the CLI or from Workbench by clicking on the InstallLib icon.
  51. Then you can start the game from Workbench or CLI. It takes no arguments.
  52.  
  53.    To play the game use the cursor keys and the space bar:
  54.  
  55.                        left - left
  56.                       right - right
  57.                          up - rotate clockwise
  58.                        down - rotate counterclockwise
  59.                       space - drop piece faster
  60.  
  61.                         f10 - pause
  62.                         esc - abort game
  63.  
  64.    The game also pauses if its window becomes inactive, make it active
  65. again to resume the game. Note also that there is an invisible drag bar
  66. and depth gadget at the top of the screen.
  67.  
  68. 3.Main menu
  69. ===========
  70.  
  71.    The options in the main menu are rather self-explaining, so I will only
  72. discuss them briefly:
  73.  
  74.    ╖ One Player Game
  75.          Starts a one player game.
  76.  
  77.    ╖ Two Player Game
  78.          Not available at the moment.
  79.  
  80.    ╖ Game Options
  81.          Brings up the Game Options menu. (see section 4)
  82.  
  83.    ╖ Merge Hiscores
  84.          If you and your friends play AHextris on multiple machines, you
  85.          can use this button to join your hiscore lists. A filerequester
  86.          will pop up, asking for the location of the other person's hiscore
  87.          file. The hiscores in that file will be merged to the hiscores
  88.          currently in memory. When you exit the game, the merged hiscore
  89.          list will be saved.
  90.  
  91.    ╖ Exit
  92.          Now what could this do ? ;^)
  93.  
  94. 4.Game Options Menu
  95. ===================
  96.  
  97.    In this menu you can alter the game's configuration. Available options
  98. at the moment are:
  99.  
  100.    ╖Player one name
  101.          Here you can enter a default name for player one. This will appear
  102.          in the name requester at the start of the game.
  103.  
  104.    ╖Ask name/Lock name 
  105.          If set to lock name, this option prevents the name requester at
  106.          the start of the game from coming up and thus forces AHextris
  107.          to use the default name.
  108.  
  109.    ╖Limited hiscores
  110.          When playing AHextris with multiple persons on the same machine
  111.          it often happens that a single person will dominate the hiscore
  112.          list, occupying almost all of the 50 entries. Usually this player
  113.          will only be interested in his highest scores but his lower
  114.          scores may prevent weaker players from achieving a hiscore entry.
  115.          If you use this option, only the 10 highest scores of each person
  116.          will be remembered enabling weaker players to keep a log of their
  117.          game play too. On the other hand this doesn't make much sense if
  118.          you play the game alone so in that case you probably won't use
  119.          this options.
  120.  
  121.    ╖Main Menu
  122.          Return to the main menu and save your options to "AHextris.options"
  123.          if they were changed.
  124.  
  125. 4.ReqTools.library
  126. ==================
  127.  
  128.    Thanks go to Nico Franτois for writing reqtools.library. It is a package
  129. that every Amiga programmer should take a look at. The following is an
  130. excerpt from the documentation of ReqTools 1.0d:
  131.  
  132.                           reqtools.library
  133.  
  134.                           (c) 1991/1992 Nico Franτois
  135.  
  136.     reqtools.library is a standard Amiga shared, runtime library.  The
  137. purpose of ReqTools is to make it a lot quicker and easier to build standard
  138. requesters into your programs.  ReqTools is designed with Commodore's style
  139. guidelines in mind, all requesters have the look-and-feel of AmigaDOS
  140. Release 2.
  141.  
  142.     If you use ReqTools in your programs you do not have to worry about
  143. requesters too much.  You'll have a lot more time to concentrate on the
  144. really important stuff your program does.
  145.  
  146.     The library has been inspired by req.library (by Colin Fox & Bruce
  147. Dawson) and Commodore's own asl.library.  You will find it shares a lot of
  148. the features with these two libraries, while it has some additional ones as
  149. well.  While asl.library was great in look-and-feel I felt it lacked quite
  150. a bit in the power department.  This power _is_ mostly available in
  151. req.library, but this doesn't fit in too well with AmigaDOS Release 2.  So
  152. the idea for a new requester library was born.
  153.  
  154.     I tried to make all requesters in ReqTools very powerful, easy to use
  155. and with a very nice new-look 3D interface.  Efficiency was also considered
  156. very important.  The 2.0 version of the library is about 20K large.  I'm
  157. sure you will agree this is not too much considering what ReqTools offers.
  158.  
  159.     ReqTools features the following requesters:  a query requester, a
  160. string requester, a number requester, a file requester, a font requester
  161. and a palette requester.
  162.  
  163. 5.Future
  164. ========
  165.  
  166.    Now that the game is out I will let it rest for some time and try to study
  167. for the upcoming exams 8^( and finish some other projects that are lying
  168. around.  I do have plans for a two player mode though, where you can play
  169. together (two falling blocks in one large container) or against each other
  170. (filling lines in your container causes lines to appear at the bottom of the
  171. other player's container). The one player version could also be extended with
  172. random hexes appearing, etc... Useful suggestions are always welcome.
  173. A non-interlace version would also be handy for the people out there who
  174. don't have a flicker fixer but since I have one I'm not very motivated
  175. at the moment (unless there's a considerable demand).
  176.  
  177. 6.Addresses
  178. ===========
  179.  
  180.    I can be reached until june '92 via e-mail on:
  181.  
  182.                            ghgagaa@cc1.kuleuven.ac.be
  183.                         or ghgagaa@blekul11.bitnet
  184.  
  185.    My snail mail address :
  186.                                   Ives Aerts
  187.                                Bareelstraat 36
  188.                                 2300 Turnhout
  189.                                    Belgium
  190.  
  191.    ReqTools can be found on ab20.larc.nasa.gov and other ftp sites. Nico
  192.    Franτois' address is :
  193.                                 Nico Franτois
  194.                                 Corbielaan 13
  195.                                  3060 Bertem
  196.                                    Belgium
  197.  
  198.    David Markley can be reached on one of these user-id's:
  199.  
  200.                           dm3e+hextris@andrew.cmu.edu
  201.                               dm3e@andrew.cmu.edu
  202.                                  dam@cs.cmu.edu
  203.  
  204.    Jeff Teague can be reached on the following user-id:
  205.  
  206.                              teague@ssd.dl.nec.com
  207.  
  208. 7.History
  209. =========
  210.  
  211.    ╖ Version 1.0
  212.       First release
  213.  
  214.  
  215. ********************************************************************************
  216.  
  217. I hope you enjoy the game ...
  218.  
  219. ⌐1992 Ives Aerts
  220.  
  221. "Kein Bestandteil sein" - Einstⁿrzende Neubauten
  222.